**
** NEPS STARTING COHORT 6 - DATA CHANGELOG 
** changes and updates for release NEPS SC6 3.0.0
**

*Known Issues*
	- labels in version 3.0.0 are not completely translated to english; full translations will follow in an upcoming data release
	- design weights for 283 latecomers from the ALWA study are missing
	- updated data manual for dataset version 3.0.0 forthcoming
	
* General*
	- Wave update from Starting Cohort 6: new wave data from second NEPS main survey (2010/2011) has been fully integrated; 
	  this scientific use file comprises now three waves (ALWA 2007/2008, NEPS 2009/2010, NEPS 2010/2010);
	  version number has been adjusted to resemble the number of cumulated wave data
	- sample size increase up to 11,932 adults since 283 additional cases from the ALWA subsample participated in wave 3
	- Selected highlights: updated and fully integrated life course data over three waves; additional concepts (like cultural capital);
	  data from competence assessment (introduced in 2010/2011); new regional data (microm)  
	- new datafiles available: spChildCohab, xTargetCompetencies (competences data, wave 3),
	  xCompMethods (para data on competence assessment, wave 3), xTargetMicrom (regional data from microm database, accessible only on-site)
	- all SPSS datasets now ship with NEPS missing values (range [-99;-5]) marked as MISSING
	- preload data for interviews in wave 3 (second NEPS wave 2010/2011) have been added; this data is usually not needed, however,
	  it might help to understand the course of an interview 
	- metadata for all datasets has been revised and updated where appropriate
	
*Spell files in general* 
	- variable spstat ('Most recent (sub-)spell status') has been revised; codes 91 and 92 have been removed
	- for tracing the generation of edited times in Biopgraphy, original variables from the check module have been added.
	  This includes: starting and ending times [{variable_start_month}_g1, {variable_start_year}_g1, {variable_end_month}_g1, {variable_end_month}_g1] 
	  as corrected by the check module, a variable marking right censoring of spell after checking routines [ts2312c_g1], and an
 	  indicator variable 'type of event' [spms] from check module, discriminating between 'dominant' and 'side' spells
	  IMPORTANT NOTE: Those variables have been added for the sake of completeness and traceability. We strongly recommand to rely on fully edited
	  episodes times that can be found in file Biography.

* Specific Issues * 
pTarget:
    - variables inty/intm (interview date) have been added for usability concerns (from file Methods)
	- small coding corrections for variables t731454 and t731404
	- variables fpmod, t733004, and t733005 were moved to file spPartner
	- variable t731301_g2 ('Mother: CASMIN') now correctly classifies observations with 'other' eductional degree as 'not determinable' [-55] 
	- variable t731351_g2 ('Father: CASMIN') now correctly classifies observations with 'other' eductional degree as 'not determinable' [-55]
	- variable t731301_g2 ('Mother: CASMIN') has been corrected, swapping contents of categories 7 [CASMIN 3a] and 8 [CASMIN 3b];
	- variable t731301_g3 ('Mother: Years of education = f(CASMIN)') has been updated accordingly
	- variable t731351_g2 ('Father: CASMIN') has been corrected, swapping contents of categories 7 [CASMIN 3a] and 8 [CASMIN 3b];
	- variable t731351_g3 ('Father: Years of education = f(CASMIN)') has been updated accordingly
	- variable t731301_g1 ('Mother: ISCED') now correctly classifies observations with 'other' eductional degree as 'not determinable' [-55] 
	- variable t731351_g1 ('Father: ISCED') now correctly classifies observations with 'other' eductional degree as 'not determinable' [-55]
	- variable t731453_g2 ('Father's occupation (KldB 2010)') now adequately incorporates information about supervisory occupational tasks where needed
	- variable t731453_g14 ('Father's occupation (ISEI-08)') has been added
	- variable t731403_g2 ('Mother's occupation (KldB 2010)') now adequately incorporates information about supervisory occupational tasks where needed
	- variable t731403_g14 ('Mother's occupation (ISEI-08)') has been added
	- a new variable t405000_g1 ('Born in Germany or abroad (reconstructed)') including an categories for born in east or west Germany has been reconstructed from spell information for non wave 1 respondents, reflecting the scale of t405000_v1
	- variables t413510_R/t413510_D ('Household: 1st foreign language') have been renamed to t413501_R/t413501_D
	- multiple response variables ("Mehrfachnennungen") have been recoded for simplifying their usage: indicator variables for "refusal", "don't know", and "not in list" have been recoded to missing codes (-98,-97,-20) in the response variables and then removed. 
	  Following multiple response sets are affected: 
		1) t725001-t725013: 'repeated school years'; missing indicators t725014 and t725015 removed 
		2) t32404k-t32404s: 'Info job'; missing indicators t32404u and t32404v	removed 
		3) t32502k-t32502t: 'Reference job'; missing indicators t32502u and t32502v removed 
		4) t32303k-t32303t: 'Help with application'; missing indicators t32303u and t32303v removed 
		5) t32405k-t32405s: 'Information job-related course'; missing indicators t32405w, t32405u, and t32405v removed
		6) t32406k-t32406s: 'Information private course'; missing indicators t32406w, t32406u, and t32406v removed
		7) t32457k-t32457s: 'Social circle further education: who?'; missing indicators t32457s, t32457u, and t32457v removed
		8) t743021-t743031: 'Fellow occupant'; missing indicators t743032 and t743033 removed
		9) t32091k-t32091s: 'Burt'; missing indicators t32091u and t32091v removed
	- variables t731403_g8, t731453_g8: EGP class scheme adjusted due to errors in the derivation syntax (particularly the classes IVc and V)

xTargetCompetencies *NEW FILE*
	- new file containing scored items and scaled values from competences assessment that was conducted at wave 3

xCompMethods *NEW FILE*
	- para data on competence assessment as generated by a specialized CAPI module at wave 3
	
spSchool:
	- variable ts11218 was recoded to -54 for spells collected in ALWA survey (wave 1); was set to system missing previously
	- variable marking right censoring of spell ts1112c has been adjusted (set to system missing for spells ending in the past)

spMilitary: 
	- variable marking right censoring of spell ts2112c has been adjusted (set to system missing for spells ending in the past)
	
spVocPrep:
	- variable marking right censoring of spell ts1312c has been adjusted (set to system missing for spells ending in the past)

spVocTrain: 
	- variable ts15215 was incorrectly labeled for ALWA cases (wave 1); an additional variable ts15215_v1 containing values and labels as generated in the ALWA survey corrects for that
    - variable ts15214_g1 had for some cases erroneously code -55 (not determinable) instead of system missings (no specification in open input abbras)
	- variable marking right censoring of spell ts1512c has been adjusted (set to system missing for spells ending in the past)
	- variable 'Description of profession/subject (ISCO-88)' ts15291_g3 now adequately incorporates information about large company size where needed
	- variable 'Description of profession/subject (ISEI-08)' ts15291_g14 has been added
	- variable 'Aspired vocational education qualification (reconstructed)' ts15221_v1 has been reconstructed, reporting contents for successfully completed episodes only
	- variable 'Aspired vocational education qualification' ts15221_ha has been added
	- variable 'vocational education qualification' ts15219_v1 no longer reports contents for episodes not successfully completed; these episodes are edited to the value -6 'no leaving certificate'

spEmp: 
	- ts23210_* was incorrectly labeled for ALWA cases (wave 1); an additional variable ts23210_v1 containing values and labels as generated in the ALWA survey corrects for that
    - ts23243 was incorrectly labeled for ALWA cases (wave 1); an additional variable ts23243_v1 containing values and labels as generated in the ALWA survey corrects for that
	- variable 'Most recent (sub-)spell status' spstat has been revised; codes 91 and 92 have been removed
	- variable 'Episode updating' ts23101 is now correctly sorted before ts23102
	- variable ts23201_g2 ('Job description (KldB 2010)')  now adequately incorporates information about supervisory occupational tasks where needed
	- variable ts23201_g3 ('Job description (ISCO-88)')  now adequately incorporates information about large company size where needed
	- variable ts23201_g14 ('Job description (ISEI-08)')  has been added
	- variable ts23221 ('Job volume at end of occupation (part-time/full-time, reconstructed)')  has been reconstructed from spell information for wave 1 interviewees, reflecting the scale of ts23218_v1
	- variable ts23201_g8: EGP class scheme adjusted due to errors in the derivation syntax (particularly the classes IVc and V) 
    - variable marking right censoring of spell ts2312c has been adjusted (set to system missing for spells ending in the past)

spUnemp:
	- variable marking right censoring of spell ts2512c has been adjusted (set to system missing for spells ending in the past)

spParLeave:
	- variable marking right censoring of spell ts2712c has been adjusted (set to system missing for spells ending in the past)
	
spGap:
	- variable marking right censoring of spell ts2912c has been adjusted (set to system missing for spells ending in the past)
	- value label for variable 'Kind of gap' ts29101_v1 has been corrected, swapping categories 6 and 7

spChild: 
	- to enhance usability when analyizing child cohabition spells,	those spells - previously being stored in a wide data format - have been extracted into a new data file called spChildCohab  
	  
spChildCohab *NEW FILE*:
	- new file containing spells of cohabitation with own or other children (the data was previously stored in wide format within spChild)
	- the file contains cohabation spells which might be extended over panel waves
	- hence, the file has a genuine spell data format involing a spell and a subspell variable
	- harmonzised spells are identified by spgen=1 and subspell=0; thus, analougsly to the other spell files 
	  just select spells having subspell=0 (Stata: keep if subspell==0) for a plain and easy episode structure  
	- cohabitation spells are related to children in spChild via the identifier "child"
	- variable marking right censoring of cohabitation spell ts3332c has been adjusted (set to system missing for spells ending in the past)
	
spPartner:
	- variables fpmod (episode mode), t733004 (living apart together, current partner), and t733005 (frequency of contact, current partner) were moved from pTarget to spPartner
	- variable ts31212_g2 ('Partner: highest educational achievement (CASMIN)') now correctly classifies observations 'other' eductional degree as 'not determinable' [-55]
	- variable ts31212_g2 ('Partner: highest educational achievement (CASMIN)' ) has been corrected, swapping contents of categories 7 [CASMIN 3a] and 8 [CASMIN 3b];
	- variable ts31212_g3 ('Partner: highest educational achievement (years of education=f(CASMIN))')  has been updated accordingly
	- variable ts31212_g1 ('Partner: highest educational achievement (ISCED)') now correctly classifies observations 'other' eductional degree as 'not determinable' [-55]
	- variable ts31226_g2 ('Partner: occupation (KldB 2010)') now adequately incorporates information about supervisory occupational tasks where needed
	- variable ts31226_g14 ('Partner: occupation (ISEI-08)') has been added
	- variable ts31226_g8: EGP class scheme adjusted due to errors in the derivation syntax (particularly the classes IVc and V) 

spFurtherEdu1: 
	- variable marking right censoring of spell t271048 has been adjusted (set to system missing for spells ending in the past)

Methods (generated file): 
	- additional wave 1 & 2 rows for additional cases from ALWA
	- new variable ALWAlatecomer marking the new cases who come from the ALWA sample but did not participate in wave 2
	- additional weights (prob_w3/weight_isced_w3/weight_isced_w3_std) for wave 3
	- new variable tx80220 (participation status) for indicating participation, temporary dropouts, and final dropouts	
	
Basics (generated file):
	- variable 'Highest CASMIN' [tx28101] now correctly classifies observations with 'other' eductional degree as 'not determinable' [-55]
	- variable 'Highest ISCED' [tx28101] now correctly classifies observations with 'other' eductional degree as 'not determinable' [-55]
	- variable 'Mother: CASMIN' [t731301_g2] now correctly classifies observations with 'other' eductional degree as 'not determinable' [-55]
	- variable 'Father: CASMIN' [t731351_g2] now correctly classifies observations with 'other' eductional degree as 'not determinable' [-55]
	- variable 'Mother: CASMIN' [t731301_g2] has been corrected, swapping contents of categories 7 [CASMIN 3a] and 8 [CASMIN 3b];
		variable 'Mother: Years of education = f(CASMIN)' [t731301_g3] has been updated accordingly
	- variable 'Father: CASMIN' [t731351_g2] has been corrected, swapping contents of categories 7 [CASMIN 3a] and 8 [CASMIN 3b];
		variable 'Father: Years of education = f(CASMIN)' [t731351_g3] has been updated accordingly
	- variable 'Mother: ISCED' [t731301_g1] now correctly classifies observations with 'other' eductional degree as 'not determinable' [-55]
	- variable 'Father: ISCED' [t731351_g1] now correctly classifies observations with 'other' eductional degree as 'not determinable' [-55]
	- variable 'Mother: SIOPS' [t731403_g6] has been added
	- variable 'Mother: MPS' [t731403_g7] has been added
	- variable 'Mother: ISEI-08' [t731403_g14] has been added
	- variable 'Mother: BLK' [t731403_g9] has been added
	- variable 'Father: SIOPS' [t731453_g6] has been added
	- variable 'Father: MPS' [t731453_g7] has been added
	- variable 'Father: ISEI-08' [t731453_g14] has been added
	- variable 'Father: BLK' [t731453_g9] has been added
	- variable 'Occupation of first employment (SIOPS)' [tx29075] has been added
	- variable 'Occupation of first employment (MPS)' [tx29076] has been added
	- variable 'Occupation of first employment (ISEI-08)' [tx29077] has been added
	- variable 'Occupation of first employment (BLK)' [tx29078] has been added
	- variable 'Current occupation (SIOPS)' [tx29065] has been added
	- variable 'Current occupation (MPS)' [tx29066] has been added
	- variable 'Current occupation (ISEI-08)' [tx29067] has been added
	- variable 'Current occupation (BLK)' [tx29068] has been added
	- variable 'Age at migration to Germany' [tx29007] has been added
	- variable 'Born in Germany or abroad (reconstructed)' [t405000_g1] has been added
	
Education (generated file):
	- variable 'Highest CASMIN' [tx28101] now correctly classifies observations with 'other' eductional degree as 'not determinable' [-55]
	- variable 'Highest ISCED' [tx28101] now correctly classifies observations with 'other' eductional degree as 'not determinable' [-55]
